Developer Documentation

QuickTime 4 API Documentation

QuickTime 4 Reference

| Previous | Chapter Contents | Chapter Top | Next |

Data Reference

To fully specify a data reference, it is necessary to provide the data reference itself, along with its type; the data reference handle does not contain the type of the data reference. The DataReferenceRecord data structure contains both of these pieces of information, making it possible to pass them to functions as a single parameter. The FlattenMovieData function uses the information in the data reference structure to flatten a movie to a data reference instead of to a file.

struct DataReferenceRecord {
    OSType  dataRefType;
    Handle  dataRef;
};
typedef struct DataReferenceRecord DataReferenceRecord;
typedef DataReferenceRecord *DataReferencePtr;

Field descriptions

dataRefType
Specifies the type of data reference. For an alias data reference, you set the parameter to rAliasType , indicating that the reference is an alias. For a handle data reference, set the parameter to HandleDataHandlerSubType .

dataRef
Specifies the actual data reference. This parameter contains a handle to the information that identifies the file to be used.

The type of information stored in the handle depends on the value of the dataRefType parameter. For example, if your application is loading the movie from a file, this parameter would contain an alias to the movie file.

© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |